home *** CD-ROM | disk | FTP | other *** search
/ PC Media 2 / PC MEDIA CD02.iso / share / udos / masdir54 / masdir.doc < prev    next >
Encoding:
Text File  |  1991-09-16  |  66.5 KB  |  1,290 lines

  1.  
  2.  
  3.  
  4.  
  5.                                    MASDIR
  6.  
  7.                          The MASter DIRectory System
  8.  
  9.                                   featuring
  10.  
  11.                                    SDL.COM
  12.  
  13.                          The Best Directory Program
  14.  
  15.                                      and
  16.  
  17.                           Disk Label Printer System
  18.  
  19.                                   Version 5
  20.  
  21.                                  August 1990
  22.  
  23.  
  24.  
  25.                     Copyright (c) 1987-1990, Bob Stephan
  26.                              All Rights Reserved
  27.  
  28.  
  29.                      For information or orders contact:
  30.  
  31.                                   MOBY DISK
  32.  
  33.                                     Phone
  34.                                 1-408-646-1899
  35.                                 1-408-646-1373
  36.                                GENIE: MOBYDISK
  37.                            COMPUSERVE: 72357,2276
  38.  
  39.                        Monterey Bay Disk Data Systems
  40.                               Attn: Bob Stephan
  41.                             1021 San Carlos Road
  42.                            Pebble Beach, CA 93953
  43.  
  44.  
  45.       MASDIR featuring SDL               Version 5              Page ii
  46.  
  47.  
  48.  
  49.                            QUICK START INFORMATION
  50.  
  51.       TUTORIAL: Please take a few minutes to read the documentation on 
  52.       the disk which includes an interactive DEMO, then experiment.  A 
  53.       few minutes doing this will show you more about using SDL than 60 
  54.       minutes of reading.  Just put a copy of the MASDIR disk in drive 
  55.       A: and enter two commands, A:, then GO, TUTOR, or DEMO.  If you 
  56.       run the TUTOR portion first you will be given a chance to run the 
  57.       DEMO portion next.  To run it later by itself just enter DEMO. 
  58.       If you enter GO or README you will be presented with a menu from 
  59.       which you can choose.
  60.  
  61.       SETUP: To use SDL simply copy SDL.COM to the disk and/or direc- 
  62.       tory in which your other DOS commands and utilities are kept. 
  63.       Then use SDL instead of DIR.  Be sure to back up your MASDIR dis- 
  64.       kette by copying everything to a formatted diskette.  You will be 
  65.       wanting to customize SDL with the setup program, so make a work- 
  66.       ing disk or directory by copying all SDL*.* files from the MASDIR 
  67.       disk to your working disk or directory.  You can run INSTALL to 
  68.       do this for you.  See SDLSETUP.DOC on the disk for more informa- 
  69.       tion if needed, or simply run SETUP after you have copied the 
  70.       files to a working disk or directory.
  71.  
  72.       WHY: SDL is designed to list and/or print directory listings in 
  73.       several formats - labels, sleeve inserts, full pages, or any way 
  74.       you want to set your printer.  It it completely replaces the woe- 
  75.       fully inadequate DOS DIR command.
  76.  
  77.       HOW: SDL is used very much like DIR. It takes the same path and 
  78.       file specifications (filespecs), but it presents a much more 
  79.       readable listing. By using 2, 4, or 6 columns of file names vice 
  80.       DIR's one, it lists many more files on one screen in a very 
  81.       readable format. If the screen becomes full, it automatically 
  82.       pauses. You can immediately shift to a different number of 
  83.       columns to see more files on the screen, exit if you have seen 
  84.       enough, or continue with the listing.
  85.  
  86.       MENUS: SDL can be used in menu mode.  Enter SDL with your 
  87.       filespec just like DIR, then make your selections from the menus 
  88.       at the bottom of the screen.  You can reconfigure the listing to 
  89.       your liking without returning to DOS.
  90.  
  91.       HELP: SDL also has many options that can be entered on the com- 
  92.       mand line in the usual fashion using / as a "switch" or option 
  93.       indicator. At first, the /? option will be useful to bring up a 
  94.       help screen.  The /? option displays a reminder of the syntax and 
  95.       options.  When running DEMO, one of the screens will show the 
  96.       result of entering SDL /?.  Your choice of options can be 
  97.       customized with the SDLSETUP program so you don't have to bother 
  98.       to enter them every time.
  99.  
  100.  
  101.       MASDIR featuring SDL              Version 5              Page iii
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.                                   CONTENTS
  110.  
  111.       QUICK START INFORMATION........................................ii
  112.  
  113.       FOREWORD........................................................v
  114.  
  115.       INTRODUCTION....................................................1
  116.  
  117.       SYSTEM REQUIREMENTS.............................................2
  118.  
  119.       HOW TO USE SDL..................................................3
  120.  
  121.       SCREEN DISPLAY OPTIONS..........................................4
  122.  
  123.       AUTOMATIC COLUMN SELECTION......................................7
  124.  
  125.       AUTOMATIC LABEL PRINTING........................................7
  126.  
  127.       PRINTING LABELS FOR 3.5 INCH DISKETTTES.........................8
  128.  
  129.       OTHER PRINT OPTIONS.............................................9
  130.  
  131.       USE OF THE PgUp, PgDn, Home, AND End KEYS......................11
  132.  
  133.       ENTERING TITLES................................................11
  134.  
  135.       FILE ATTRIBUTES................................................12
  136.  
  137.       VOLUME LABELS..................................................13
  138.  
  139.       CATALOGING FLOPPIES WITH SDL...................................13
  140.  
  141.       BATCH PROGRAMMING..............................................14
  142.  
  143.       CUSTOMIZATION..................................................15
  144.  
  145.       RUNNING SDLSETUP...............................................15
  146.  
  147.       LICENSE AND WARRANTY STATEMENTS................................20
  148.  
  149.  
  150.       MASDIR featuring SDL               Version 5              Page iv
  151.  
  152.  
  153.  
  154.                                                        FOREWORD .  .  .
  155.  
  156.       This documentation may seem extensive for a directory program, 
  157.       but MASDIR has so many useful features that I want to make sure 
  158.       you know about them all.  Please read the TUTORIAL first by en- 
  159.       tering TUTOR or run the demo by entering DEMO.  Then, experiment 
  160.       a little with SDL to get the hang of it.  After that, read this 
  161.       to obtain the full benefits of using SDL.
  162.  
  163.       Of course, nobody is going to bother to print a label for just 
  164.       one disk at a time, or even for only 2 or 3.  What I find con- 
  165.       venient is to print sleeve inserts or hand write small, removable 
  166.       labels to remind me what is on a disk.  Then when I have accumu- 
  167.       lated a half dozen or more I load my printer with labels and 
  168.       label them all.  SDL makes it convenient to do it that way, and 
  169.       it makes it more likely that permanent labels will be prepared 
  170.       only for disks that have information of a more permanent nature. 
  171.       Version 5 makes it even easier to do batch labelling because it 
  172.       can read and display the directory of a new diskette without hav- 
  173.       ing to return to DOS.
  174.  
  175.       Laser printer versions of MASDIR are available for printing 
  176.       sleeve inserts, but laser printers are not supported for printing 
  177.       disk labels.  The labels available from MOBY DISK are not 
  178.       suitable for use with laser printers.
  179.       ---------------
  180.       ACKNOWLEDGMENTS
  181.  
  182.         I would like to thank members of MBUG-PC - The Monterey Bay 
  183.       Users' Group - for their indulgence during my development of this 
  184.       system.  Many members have used preliminary versions and offered 
  185.       their comments and suggestions.  I am particularly grateful to 
  186.       the beta testers who held my feet to the fire to ensure that this 
  187.       would be a reliable and useful product.  Among those who have 
  188.       been particularly helpful are (in alphabetical order) John 
  189.       Blankfort, Fred Brownell, Frank Murphy, Patt Patterson, Bing 
  190.       Perry, Ben Rees, Jim Robeson, and Keith Whipple.  Other members 
  191.       encouraged me by purchasing my initial offerings, which rein- 
  192.       forced my conviction that this is a useful system with unique ca- 
  193.       pabilities.
  194.       ---------------
  195.       ABOUT THE AUTHOR
  196.  
  197.       Bob Stephan has been using and programming computers for over 22 
  198.       years, mostly for other companies and for his own use and enjoy- 
  199.       ment.  This is his first independent commercial venture.  He has 
  200.       been a mainstay in his local computer users group for over 7 
  201.       years and is a past president as well as an author of informative 
  202.       articles for the newsletter, leader of special interest groups, 
  203.       and provider of help to members on a variety of topics.
  204.  
  205.       MASDIR featuring SDL               Version 5               Page 1
  206.  
  207.  
  208.       INTRODUCTION
  209.  
  210.         SDL is a Sorted Directory Listing program that is used in place 
  211.       of the DOS DIR command.  You can invoke it from the DOS prompt 
  212.       just like DIR, and it accepts the same file specifications 
  213.       (filespecs) that DIR does including paths and wild cards.
  214.  
  215.         But there the similarity ends.  SDL has these features:
  216.  
  217.         <> Sorts the listing alphabetically by name, or optionally by 
  218.            extension, date, size, or (like DIR) not at all.  The sort- 
  219.            ing can be in ascending or descending order, and the se- 
  220.            quence can be from top to bottom, or from left to right.
  221.  
  222.         <> Automatically formats the listing in the number of columns 
  223.            that will fit all the file names on one screen, if possible. 
  224.            This permits you to see up to 144 file names on the screen 
  225.            to get a good overall view of the contents of the disk or 
  226.            directory.  Optionally 2, 4, or 6 columns can be specified 
  227.            and/or set as the default.
  228.  
  229.         <> SDL pauses after each screen until you are ready to con- 
  230.            tinue.  At the pause you can make a new column or sort se- 
  231.            lection, exit, or continue.  Pausing is optional and can be 
  232.            turned off either by default or as an option.
  233.  
  234.         <> The options are selectable on the command line by adding 
  235.            them to the SDL command (like you can add /P or /W to the 
  236.            DIR command).
  237.  
  238.         <> Most options can also be selected from a menu that is pre- 
  239.            sented at the bottom of the screen at the end of each screen 
  240.            of the listing.  This permits you to change your mind as 
  241.            often as you like, and adjust the listing to obtain just the 
  242.            right information from it without having to return to DOS 
  243.            and enter a new command.
  244.  
  245.         <> A TUTORIAL which includes an interactive DEMO.
  246.  
  247.         <> A SETUP program that lets you select your own defaults for 
  248.            the various options by simple keystroke entries in response 
  249.            to a few questions.  You can make SDL work the way you want 
  250.            it to.
  251.  
  252.         <> On-screen help by entering SDL /?.
  253.  
  254.         <> Unique to SDL are some excellent printing capabilities for 
  255.            both 5.25" and 3.5" diskettes!  With a single keystroke you 
  256.            can print the directory you see on the screen in your choice 
  257.            of four print modes:
  258.  
  259.            1.  Regular printing in whatever mode your printer is set 
  260.               for with no changes to your printer setting.
  261.  
  262.       MASDIR featuring SDL               Version 5               Page 2
  263.  
  264.  
  265.  
  266.            2.  A "sleeve insert", which is printed on your regular 
  267.               printer paper in a format that can be trimmed to a con- 
  268.               venient size to slip into the diskette sleeve for future 
  269.               reference.
  270.  
  271.            3.  A disk label which can be printed on the continuous 
  272.               labels that are included with the SDL system kit.  By 
  273.               using compressed print and 8 lines per inch up to 42 
  274.               filenames can be printed on a 5x1-7/16" label.
  275.  
  276.            4.  Another style of disk label printing which uses "tiny" 
  277.               printing to fit up to 102 names onto a label.  Tiny print 
  278.               makes use of the compressed and superscript modes that 
  279.               are available on Epson compatible printers.
  280.  
  281.            5.  And, if you select a printing option on the command 
  282.               line, the number of columns needed to fit the filenames 
  283.               on a label will be automatically calculated and set.  If 
  284.               there are too many file names, a message is displayed and 
  285.               no printing takes place.
  286.  
  287.         <> Very useful when using a print option is the ability to en- 
  288.            ter up to 3 lines of titles for your sleeve inserts or 
  289.            labels.  Two of these lines can be customized with the setup 
  290.            program, and any or all of the 3 can be specialized for any 
  291.            individual listing.
  292.  
  293.         <> Other directory listing options include turning off the 
  294.            listing of subdirectories, listing the combined files for 
  295.            two file specifications, listing only those files created 
  296.            since a certain day, listing only files with the archive bit 
  297.            set, showing total size required for different disk formats, 
  298.            listing from left to right instead of top to bottom, and 
  299.            paging backward and forward through long directory listings.
  300.  
  301.         <> Automatic support of color, EGA, and VGA modes.  Highlighted 
  302.            key-letter colors can be customized in the SETUP program.
  303.       --------------
  304.       SYSTEM REQUIREMENTS
  305.  
  306.         SDL is compatible with all computers running under MS or PC-DOS 
  307.       Versions 2.0 and later, although 3.1 or later is preferred.  It 
  308.       requires no more than 64K of memory.  It is not memory resident 
  309.       (TSR) and will not reduce the amount of memory available to other 
  310.       programs.  It supports all types of monitors and display adapters 
  311.       whether monochrome or color.
  312.  
  313.       NOTE: To support the many features it is preferable if you are 
  314.       running DOS 3.1 or later.  SDL requires at least DOS 2.0, but a 
  315.       few features may not work fully, especially in the setup program 
  316.       SDLSETUP.  Please let me know if you have any problems or com-
  317.  
  318.       MASDIR featuring SDL               Version 5               Page 3
  319.  
  320.  
  321.       ments concerning the operation of SDL, SDLSETUP, or any part of 
  322.       the documentation portion of the system.  Customized versions can 
  323.       be prepared for a reasonable fee.  If you have difficulty finding 
  324.       disk labels in the proper size, contact me for information, or 
  325.       send in the order form.
  326.       --------------
  327.       HOW TO USE SDL
  328.  
  329.         Basically SDL is used just like the DOS DIR command with quite 
  330.       a few enhancements.  Both SDL and DIR accept the same file speci- 
  331.       fications (filespecs) including the "wild cards" * and ?.  For 
  332.       more detailed information on the use of wild cards see your DOS 
  333.       manual.
  334.  
  335.         HINT:  It is never necessary to enter *.* with either DIR or 
  336.       SDL.  A single * will serve the same purpose and save a bit of 
  337.       typing.  For all files in the current directory no filespec at 
  338.       all is needed, simply enter SDL.  More information on shortcuts 
  339.       for filespecs is presented later in this document.
  340.  
  341.         The best and quickest way to learn to use SDL is to run the 
  342.       TUTORIAL on the disk or run the DEMOnstration program by itself. 
  343.       Most of this introductory information can be found in the 
  344.       tutorial.  Read the QUICK START INFORMATION page at the beginning 
  345.       of this document for instructions on running the tutorial.
  346.  
  347.         The key to using SDL is the reminder line which appears as the 
  348.       second line of the display.  It contains the following informa- 
  349.       tion which is explained fully in this document.
  350.  
  351.       /OPTS:/? More PRInt Cls titlE Hdr Fre Lbl All rK Byt Wid 2 4 6 N 
  352.       X S D[n] - dOs
  353.  
  354.         This line may appear cryptic, but it contains mnemonics for all 
  355.       of the SDL options as memory aids until you become thoroughly fa- 
  356.       miliar with SDL.  The capitalized letters are key-letter switch 
  357.       characters which are highlighted on the screen.  Although there 
  358.       are quite a few options to provide the capabilities requested by 
  359.       users, you will find them to be quite intuitive and easy to use. 
  360.       After a few minutes of experimentation you will find a few of 
  361.       them that you like to use.  This experimentation can be taken 
  362.       care of in the DEMO program.
  363.  
  364.         As soon as you find the options that you like, you can 
  365.       customize your copy of SDL with the SDLSETUP program.  I have 
  366.       tried to set SDL up the way I believe most users would like to 
  367.       use it, but you might want to change it for your own use.  If you 
  368.       would like one or more of the defaults to work differently, run 
  369.       SDLSETUP.  Then it will only be necessary to use options oc- 
  370.       casionally when you want something different.  The SDL /? help 
  371.       screen is always available as a reminder at those times.  The 
  372.       README program will give you an opportunity to read the SDLSETUP
  373.  
  374.       MASDIR featuring SDL               Version 5               Page 4
  375.  
  376.  
  377.       documentation, but SDLSETUP is easy to use, requiring only simple 
  378.       single keystroke answers.
  379.  
  380.         The printing capabilities of SDL are most useful and remarkably 
  381.       easy to use.  For example, to print a label of the diskette in 
  382.       drive A, just enter SDL A: /L.  Nothing could be simpler.  The /L 
  383.       is an option mnemonic for Label, and SDL will calculate how many 
  384.       file names it can fit on a label and select the print mode to do 
  385.       it.  Of course, if you want more control, and less automation, 
  386.       SDL will always let you make your own specifications.  You can 
  387.       print labels in either of two print styles, labels and sleeve in- 
  388.       serts in a variety of sort orders and columns of file names, or 
  389.       you can print with your own normal printer setting.  Adding the 
  390.       3-line title option (/E) provides a means to include printed ex- 
  391.       planatory information about the contents and use of the disk.
  392.  
  393.         The documentation that follows assumes that you have already 
  394.       familiarized yourself with SDL by running TUTOR and DEMO.
  395.       ----------------------
  396.       SCREEN DISPLAY OPTIONS:
  397.  
  398.         SDL can be used in command line mode, menu mode or a combina- 
  399.       tion of the two.  The "command line" is the line on your screen 
  400.       following the DOS prompt on which you enter your commands.  The 
  401.       general syntax of the SDL command line entry is
  402.  
  403.       D>SDL filespec /options
  404.  
  405.       where D> represents the DOS prompt.
  406.  
  407.         To enter an option on the command line use the / character fol- 
  408.       lowed by the letter, number, or symbol shown as the key character 
  409.       in the reminder line (the letters shown in CAPS).  The options 
  410.       must come after the file specification (filespec), and each must 
  411.       be preceded by the switch character / (the virgule).  The only 
  412.       required space is the one following the SDL command itself, other 
  413.       spaces are optional, but there must NOT be a space between the / 
  414.       and the option character.  Most options allow only one character 
  415.       in addition to the virgule per option.  For example, to sort by 
  416.       Size and display in 4 columns you can enter
  417.  
  418.       >SDL /S/4
  419.  
  420.         Menu mode is automatic.  At the bottom of each screen a prompt 
  421.       will display the keys that can be entered to make selections. 
  422.       Not all of the command line options are available as menu selec- 
  423.       tions; however, the most useful ones are.
  424.  
  425.         All options can be entered in either upper (CAPS) or lower 
  426.       case.  They are shown in CAPS on the reminder line merely to 
  427.       highlight them.  When entered on the command line they must be 
  428.       preceded by /, but when making menu selections just use the key
  429.  
  430.       MASDIR featuring SDL               Version 5               Page 5
  431.  
  432.  
  433.       letter, number, or symbol by itself and you don't need to use the 
  434.       Enter key.  In some cases using an option on the command line may 
  435.       have a slightly different meaning than using it from the menu. 
  436.       If there is such a distinction, this documentation uses the / 
  437.       notation to distinguish the command line selection.
  438.  
  439.         After each screen is displayed on your monitor, you have 
  440.       several options.  If there is more of the directory to display, 
  441.       you will see an intermediate menu starting with "--More--".  At 
  442.       this point you may want to make a new selection to change the 
  443.       display.  The prompt will show the options as a reminder of the 
  444.       ones available with the option keys highlighted.  Pressing one of 
  445.       them will immediately start the directory over again with the new 
  446.       display that you have requested, even if it is the same as is al- 
  447.       ready being displayed.  This is the way you can go back and look 
  448.       at the previous screens of a multi-screen display.  If you want 
  449.       to exit at this point press Esc.  Pressing C or PgDn will clear 
  450.       the screen and continue with the next "page".  Pressing any key 
  451.       not listed will continue with the next screen in a scrolling 
  452.       mode.  If there has been more than one screen of filenames dis- 
  453.       played, pressing PgUp will go back to the previous screen.  At 
  454.       the first screen, PgUp will suppress the header so that up to 144 
  455.       file names can be displayed.
  456.  
  457.         The last line of the directory display shows the number of 
  458.       files, and optionally the total amount of disk space they occupy. 
  459.       After this file count is shown, you may select one of the keys 
  460.       shown in the menu to start the display over.  The space bar, En- 
  461.       ter or Esc key will EXIT from SDL.  The Esc key will NOT clear 
  462.       the screen.  This permits you to leave the directory on the 
  463.       screen if you so desire even if Cls is on.  Other items can be 
  464.       selected from the menu as described later.
  465.  
  466.         You may select a print option (/P, /R, /I, or /L) on the com- 
  467.       mand line.  If you specify /L, the display will automatically be 
  468.       adjusted for printing a label.  If you specify /I a sleeve insert 
  469.       will be printed.  If you select /P or /R you will see a print 
  470.       menu from which you can make a selection.  When printing, each 
  471.       screen selected will be printed, but the prompts and your input 
  472.       are not sent to the printer.
  473.  
  474.         /C or C is the clear screen (Cls) option.  This controls the 
  475.       clearing of the screen before each page of file names, and at the 
  476.       end of the display.  Pressing C or PgDn at the end will do a one- 
  477.       time clear screen (Cls) and start form feeding (ff) to the 
  478.       printer if printing is on, but will not change the Cls setting. 
  479.       After the Cls, the directory will be displayed in the same sort 
  480.       order and columns as the most recent selection.
  481.  
  482.         /M stands for More and toggles the pausing at the end of a page 
  483.       (screen).  You may use the /M option to eliminate all pausing, 
  484.       both intermediate and at the end.  This disables the menu selec-
  485.  
  486.       MASDIR featuring SDL               Version 5               Page 6
  487.  
  488.  
  489.       tion procedure.  If pausing is defaulted to off by running 
  490.       SDLSETUP, /M will turn it on.  For compatibility with earlier 
  491.       versions you can change the /P option to Pause with SDLSETUP to 
  492.       do the same thing.  Otherwise /P is used to bring up the print 
  493.       (Prn) menu.
  494.  
  495.         /H stands for Header (or Hdr).  The H option controls whether 
  496.       the first two title lines of the header are displayed.  When 
  497.       using SDL as a directory program for hard disk listings on the 
  498.       screen, the first two lines are just boring repetition.  The 
  499.       third line presents the useful "Directory of ..." information 
  500.       giving the subdirectory name for the listing, but the first two 
  501.       lines don't change and might as well be suppressed to allow two 
  502.       more rows for file names.  At other times, such as when printing 
  503.       a label for a diskette, all three lines can contain useful in- 
  504.       formation if you use the title option.
  505.  
  506.         /F is the option to display disk Free space.  For hard disks 
  507.       the amount of free space is not generally of interest unless the 
  508.       disk is quite full.  DOS takes a noticeable amount of time to 
  509.       calculate the disk free space on large hard disks, so eliminating 
  510.       the display of this information greatly speeds up the directory 
  511.       display.  The setup program has an option to adjust this to your 
  512.       liking.  The /F option on the command line, or selecting F from 
  513.       the menu will toggle it.
  514.  
  515.        The calculation of the total "Bytes in xxx Files" is rounded up 
  516.       to the next exact kilobyte for each file.  (Individual file sizes 
  517.       are not.)  In previous versions the total was not very useful in 
  518.       that it did not indicate the amount of disk space actually used 
  519.       by the files.  Rounding the size to K-bytes makes it agree with 
  520.       the amount of space used on a floppy disk.  If you do a CHKDSK on 
  521.       a floppy, the amount of space used for the same set of files will 
  522.       now agree with the SDL total.  A common use for this total is to 
  523.       determine whether certain files will fit on a floppy.  The new 
  524.       calculation makes it possible to make this determination ac- 
  525.       curately.  You can also adjust the rounding to indicate the total 
  526.       size on various disk formats as described later.
  527.  
  528.         There is a W or /W option that will list the files in sort or- 
  529.       der across the Width of the screen vice down the columns.  When 
  530.       printing a 3.5" disk label this is the only method of listing 
  531.       file names that is available, but for listing on the screen or on 
  532.       a 5" label you can choose by toggling W.
  533.  
  534.         Another useful feature is the option to set the cluster size 
  535.       for the total bytes. Since 1.2Mb and 1.44Mb disks use 1-sector 
  536.       clusters, the default rounding up of the file size total in 1Kb 
  537.       increments is not accurate for these disks (or for hard disks). 
  538.       The /B (for Bytes) command line option is available to adjust for 
  539.       the number of kilobytes per cluster. /B1 (the default) for 1 Kb 
  540.       (2 sectors) per cluster as on 360k and 720k diskettes, /B for .5
  541.  
  542.       MASDIR featuring SDL               Version 5               Page 7
  543.  
  544.  
  545.       Kb (1 sector) per cluster as on 1.2Mb and 1.44Mb diskettes, and 
  546.       /Bn, n=2-8 for hard disks as appropriate where n indicates the 
  547.       number of Kb per cluster. This option is only available on the 
  548.       command line, but SDLSETUP is able to set the default as desired. 
  549.       Note that just /B (or /Banything other than 1-8) drops to 1 sec- 
  550.       tor per cluster, and /B1 is the same as the current default.  The 
  551.       number, if used, must immediately follow the B with no spaces.
  552.  
  553.         Reverse sorting.  The '-' character is the symbol to sort the 
  554.       file names in descending, vice ascending order.  On the command 
  555.       line this can be /-, /a-, or /-a where a is one of the alphabetic 
  556.       characters N, X, S, or D. (There is no reverse for DOS order.) 
  557.       At either the end or the intermediate menu, pressing the "-" key 
  558.       will re-sort the names in reverse order using the same sort 
  559.       field.
  560.  
  561.          SDL automatically adjusts for any number of lines of text your 
  562.       monitor is set for such as 43 line EGA, or 50 line VGA modes.  It 
  563.       also uses the foreground and background colors that you currently 
  564.       have set on your screen.  The color of the highlighted key let- 
  565.       ters in the menu can be changed in SDLSETUP.
  566.  
  567.         Other options are described in more detail below.  The default 
  568.       state of these various screen display options can be set to your 
  569.       liking by using the SDLSETUP program.
  570.       ---------------------------
  571.       AUTOMATIC COLUMN SELECTION
  572.  
  573.         Unique to SDL is the AUTOmatic column selection feature.  In 
  574.       its original default mode, SDL will determine from the number of 
  575.       files how many columns it will take to display all of the file 
  576.       names.  Unless there are more files than will fit on the screen 
  577.       in 6 columns (114 or 126 depending on the header), you will see 
  578.       all of the file names on the first screen.  This lets you see at 
  579.       a glance the general contents of a disk or directory.  If you 
  580.       then need to see more detail, you can make a new selection from 
  581.       the menu.
  582.  
  583.         The automatic feature is easily overridden by entering a firm 
  584.       column option on the command line (/2, /4, or /6).  The default 
  585.       can also be set to a firm number with SDLSETUP if you prefer. 
  586.       The label printing options (/L) described later will cause any 
  587.       other default or command line column options to be overridden.
  588.       ------------------------
  589.       AUTOMATIC LABEL PRINTING
  590.  
  591.         There are two options that can be entered on the command line 
  592.       to activate automatic label printing - /L and /P.  /L automati- 
  593.       cally prints a label.  /P causes a printing option menu to be 
  594.       displayed.  From this menu you can select L, R, I, T, Esc, or 
  595.       just Return <CR>.
  596.  
  597.  
  598.       MASDIR featuring SDL               Version 5               Page 8
  599.  
  600.  
  601.         When you select from the menu, L and T set Epson compatible 
  602.       printers for 1-7/16" labels.  L prints in compressed width at 8 
  603.       lines per inch, and T in "Tiny" print using superscript, com- 
  604.       pressed, and about 14 lines per inch.  Continuous feed labels of 
  605.       this convenient size are available from at a nominal price if you 
  606.       cannot find them at your office supplier.  If the menu is pre- 
  607.       sented because of /P on the command line, the number of columns 
  608.       will be calculated automatically to fit the file names on a 
  609.       label.  If there are too many names a message will be displayed. 
  610.       If L is selected after files have been displayed, the number of 
  611.       columns is not recalculated, but is printed as you see it dis- 
  612.       played.
  613.  
  614.         /L is the most general of the command line print options.  When 
  615.       you use /L you do not need to know the number of files ahead of 
  616.       time and make calculations.  The algorithm calculates the number 
  617.       of files that will fit in 4 columns using the L mode.  If the ac- 
  618.       tual number of files is greater, the T mode is automatically 
  619.       selected instead.  The other print options (R or I) described be- 
  620.       low are not affected by the /L option.
  621.  
  622.         You may combine the /P, /I, or /L options with other options 
  623.       such as the /E option which will allow you to add up to 3 lines 
  624.       of titles to the label or insert.
  625.  
  626.         You may also see the print menu by selecting P at the end-of- 
  627.       directory menu.  To give you full control when you want it, NO 
  628.       automatic calculation takes place if P is selected from the menu 
  629.       instead of on the command line.  Thus you can view the display, 
  630.       select the number of columns and sort order you want, enter 
  631.       titles if desired, and then print in the mode that you select. 
  632.       This could be useful if you use a different size label, want to 
  633.       print on paper in Tiny print, or just want to see the file names 
  634.       and set up the options before printing.  By having full control 
  635.       you also have the responsibility to be sure the printout will fit 
  636.       on the printing medium.  No assumption is made about the number 
  637.       of file names that will fit, and printing will continue until the 
  638.       full directory is printed if either W or T is selected from the 
  639.       menu at the end of the display.
  640.  
  641.         If you select conflicting print options, /P and /L, no harm 
  642.       will be done, but the first option will will be the one used and 
  643.       the other will be ignored.
  644.  
  645.       ---------------------------
  646.       PRINTING LABELS FOR 3.5 INCH DISKETTTES
  647.  
  648.         The printing directory labels for 3.5" disks is controlled by 
  649.       the 3 and 5 options--3 for 3.5" disks and 5 for  5.25" disks. On 
  650.       the command line you can enter either /3 or /5 to prepare SDL to 
  651.       print the style of label you want. The Print Options menu is 
  652.       brought up by entering either P from the menu, or /P or /R on the
  653.  
  654.       MASDIR featuring SDL               Version 5               Page 9
  655.  
  656.  
  657.       command line. From this menu you can select, or change your se- 
  658.       lection, by pressing either 3 or 5 as appropriate. The default 
  659.       3.5" disk form depth is set for the 2-3/4" labels that wrap 
  660.       around the top of the disk. The setup program permits setting it 
  661.       for the 2" labels that do not wrap.  The default is set for the 
  662.       5.25" labels, so use the 3 or /3 option to get 3.5" labels, or 
  663.       change it with SDLSETUP. (For convenience the labels and disks 
  664.       will be referred to as 3" and 5".)
  665.  
  666.       Until actual printing is started the screen display will be the 
  667.       normal display.  If 3" disk label or Insert printing is selected, 
  668.       when printing starts, each line of the display will be split to 
  669.       fit the 2-3/4" width of the label.  Thus, a 2 column screen dis- 
  670.       play will result in a 1 column 3" disk label, a 4 column screen 
  671.       display will be a 2 column label, and a 6 column screen display 
  672.       will be a 3 column label.  The 2, 4, and 6 selections remain un- 
  673.       changed for either type of label.  To keep the file names sorted 
  674.       properly, the W option will automatically be invoked during the 
  675.       printing of labels for 3" disks.
  676.  
  677.       The R print option is not affected by the label setting, but the 
  678.       File option is.  You can use this to create a directory catalog 
  679.       file with space for your own comments after each file name.
  680.  
  681.       When entering titles for 3" labels, each line will be split after 
  682.       the 40th character.  The vertical bar indicates the position of 
  683.       the last character that goes on the first line of the split.  The 
  684.       next character after the bar will start the second line of the 
  685.       split.  If you need to see the effect of the split on the screen 
  686.       before printing use the File option and create a temporary file 
  687.       that can be erased later.  Then "what you see is what you get". 
  688.       When it is what you want you can select the print mode.
  689.       ---------------------------
  690.       OTHER PRINT OPTIONS - R, I, PgDn, and C.
  691.  
  692.         R for 'Regular' leaves your printer unchanged as you have set 
  693.       it yourself.  This permits any printer to print the directory 
  694.       listing from SDL in any manner that you want to set your printer. 
  695.       Note that all listings will fit on the standard Pica 80 column 
  696.       printer.  The default number of columns for R (and for I) is the 
  697.       same as for a screen display (AUTO, 2, 4, or 6) and can be 
  698.       specified in the same ways.
  699.  
  700.         I stands for sleeve Insert.  It uses the same printing mode as 
  701.       L, but sets the form length to 1/2 of a standard page (5-1/2") 
  702.       for printing diskette sleeve inserts.  This permits 2 inserts to 
  703.       be printed on a standard sheet.  They can then be easily trimmed 
  704.       to fit into the diskette sleeve.  Note that printing doesn't stop 
  705.       when the 5-1/2 inch form bottom is reached.  Just as with any 
  706.       printing, if you give the printer more than will fit on a page, 
  707.       it just continues printing onto the next page.  Since sleeve in- 
  708.       serts can be easily folded, this permits an unlimited number of
  709.  
  710.       MASDIR featuring SDL               Version 5              Page 10
  711.  
  712.  
  713.       files to be listed.  If you prefer a full page for each sleeve 
  714.       insert so as not to change your Top Of Form (TOF) setting, you 
  715.       can make that change with SDLSETUP.
  716.  
  717.         Print-to-file. Now on the Print Options menu a "File" option 
  718.       appears. If you select F you will be prompted for a file name. 
  719.       This can be any valid non-ambiguous file specification (no wild- 
  720.       cards). If the file exists, the directory output will be appended 
  721.       to the end of the file.  Be careful not to use reserved DOS names 
  722.       such as COM1, AUX, LPT1, PRN, NUL, etc. unintentionally.
  723.  
  724.         All of the print options can be selected from the print (Prn) 
  725.       menu at the end of the directory display.  As mentioned above, 
  726.       there is a difference if /P is entered on the command line or P 
  727.       selected from the menu for the L and T selections.  The print 
  728.       mode is the same, but SDL lets you take control of the number of 
  729.       columns.  Note also that L, I and T require a certain degree of 
  730.       compatibility with IBM/Epson printer control codes, although they 
  731.       do not print any of the extended ASCII graphics characters.  But 
  732.       see CUSTOMIZATION below.
  733.  
  734.         After printing with /L, L, I or T, your printer will be 
  735.       restored to Compressed OFF, Script OFF, and the standard 6 
  736.       lines/inch.  Note that if you interrupt with Ctrl-C or Ctrl-Break 
  737.       before the entire file list is printed, the printer will not be 
  738.       reset.  The same will happen if you clear your printer buffer be- 
  739.       fore it completes printing if you have a print spooler.  However, 
  740.       if you use Esc to abort SDL, your printer will be restored as 
  741.       above.  When you exit normally or with Esc, a form feed is sent 
  742.       to the printer so that you can realign your Top Of Form (TOF) 
  743.       setting.  No form feed is sent if the R option is selected.
  744.  
  745.        Control of printing is very versatile.  The prompt line indi- 
  746.       cates whether printing is on or off (Prn=ON or Prn=OFF).  At the 
  747.       print menu Esc will turn printing off if it was on or exit 
  748.       without turning it on.  Pressing C for Cls (or PgDn) turns on 
  749.       page eject (ff for form feed).  This is also indicated on the 
  750.       prompt line with (ff=ON or ff=OFF).  Turning printing off at the 
  751.       print menu with Esc will also turn off ff until you press C or 
  752.       PgDn again.  Thus you can turn these features on or off, and you 
  753.       can change from one print mode to another without exiting to DOS.
  754.  
  755.         When you select any print mode you have the option of form 
  756.       feeding your labels, sleeve inserts, or sheets at the end of each 
  757.       directory.  This is useful if you are making more than one copy. 
  758.       If you want to start form feeding labels, sleeve inserts, or your 
  759.       own setting (with R), press C at the menu.  This will clear the 
  760.       screen, and if a print mode has already been selected will send a 
  761.       form feed to the printer and turn form feeding ON for future se- 
  762.       lections.  Thus any subsequent selections, will continue to send 
  763.       form feeds to the printer and clear the screen.  If you don't 
  764.       want any form feeds sent to the printer, just don't press C.  If
  765.  
  766.       MASDIR featuring SDL               Version 5              Page 11
  767.  
  768.  
  769.       you have not yet selected a print mode, the C selection will only 
  770.       do a Cls.
  771.  
  772.         Of course, each time you invoke SDL from the DOS prompt it is a 
  773.       fresh copy that is running, so only your default selections can 
  774.       be carried over from one call to the next.  It is only as long as 
  775.       you continue to make menu selections that the above information 
  776.       about subsequent selections applies.  However, many of the op- 
  777.       tions can be set permanently the way you want them by using the 
  778.       SDLSETUP program.
  779.  
  780.         Other methods of printing the output are available.  The usual 
  781.       CtrlPrtSc and ShiftPrtSc, of course, as well as re-direction 
  782.       using the command line option >PRN.  These methods do not require 
  783.       Epson printer control code compatibility, but they do try to 
  784.       print the extended ASCII graphic characters you see on the 
  785.       screen.  These will print as different characters on some 
  786.       printers.  The prompts will be seen, but it is best to use the /M 
  787.       option when using redirection to eliminate the prompts.  You can 
  788.       also use redirection to write the directory to a file.  If you 
  789.       use redirection with /E you will have to enter the titles in the 
  790.       blind (a feature of DOS).  Do NOT use both a print option and 
  791.       redirection to the printer.  If you do, everything will be 
  792.       printed twice and the formatting will be uncontrolled.
  793.       -----------------------------------------
  794.       USE OF THE PgUp, PgDn, Home, AND End KEYS
  795.  
  796.         These keys can be very useful for paging backward and forward 
  797.       through large directories.  Pressing the PgUp key will redisplay 
  798.       the previous screen.  This can also be used on the first screen 
  799.       to eliminate the header completely and display up to 144 
  800.       filenames on one screen.  PgDn pages to the next screen the same 
  801.       as C, End scrolls to the end of the directory, and Home returns 
  802.       to the first screen--similar to pressing C at the end menu, but 
  803.       Home can also be used for this purpose at the intermediate menu.
  804.  
  805.       Pressing End will SCROLL to the end of the directory and pause, 
  806.       leaving the last page on the screen.  If printing was on, it will 
  807.       be turned off before scrolling.  If PgUp is then pressed, it will 
  808.       jump back to the beginning of the file list.  Note that both End 
  809.       and PgUp turn off printing if it is on, while Home and PgDn will 
  810.       print another copy of the listing similar to C.
  811.       ---------------
  812.       ENTERING TITLES
  813.  
  814.         E stands for Entitle (or titlE) and is very useful for adding 
  815.       titles to printed directory listings.  Specifying an option of /E 
  816.       on the command line or E from menu will result in prompts for up 
  817.       to 3 lines of titles to replace the text in the first three lines 
  818.       of the display header.  The number of titles to be entered will 
  819.       be the same as the number of header lines, and is dependent on 
  820.       the current H (for Hdr) setting.  The first title can contain up
  821.  
  822.       MASDIR featuring SDL               Version 5              Page 12
  823.  
  824.  
  825.       to 45 characters and fits on the first half of the top line leav- 
  826.       ing the "Vol:" information unchanged.  The other two titles can 
  827.       be up to 79 characters.  The second title replaces the reminder 
  828.       line.  The third title replaces the "Directory of ..." line, but 
  829.       usually diskettes don't have subdirectories so no information is 
  830.       lost.  The first two titles can be customized by using the 
  831.       SDLSETUP program.  If the Hdr option is off, only the third title 
  832.       line can be entered, but you can turn the header back on by se- 
  833.       lecting H from the menu, or it can be controlled by /H on the 
  834.       command line.
  835.  
  836.         Just pressing <enter> for any line will leave that line un- 
  837.       changed from your default or previous entry.  To blank out a line 
  838.       completely just enter one or more spaces.  The E option, in con- 
  839.       junction with the  enhanced print options for printing disk 
  840.       labels or sleeve inserts, provides much more flexibility than 
  841.       other directory printing programs.
  842.  
  843.         /E is really g-r-r-r-e-a-t when printing multiple copies of 
  844.       labels or inserts, such as for disks to be sold or distributed by 
  845.       clubs or individuals. At the end of each directory just press the 
  846.       C key and it will position and print the next label or insert im- 
  847.       mediately without having to read the directory of the disk again. 
  848.       The same titles will be used.  It is fast, and the options can be 
  849.       changed from one to the next.  Once C has been pressed, any other 
  850.       valid selection will continue to conveniently form feed your 
  851.       labels, inserts, or pages.  If you do not want to use form feed- 
  852.       ing, just don't press C or PgDn.
  853.  
  854.         I would like to point out a convenience for users of CED (the 
  855.       Shareware Command EDitor or its commercial version, PCED). When- 
  856.       ever you enter titles for SDL, CED saves them in its application 
  857.       stack buffer.  If you select E again or exit to DOS then call SDL 
  858.       again with the /E option, you can retrieve the titles you used 
  859.       before with the up and down arrow keys, edit them if you like, 
  860.       and enter them again.  It can save a LOT of typing.
  861.       ----------------
  862.       FILE ATTRIBUTES
  863.  
  864.         The file attributes are Archive, Hidden, Read only, and System. 
  865.       In the 2-column display, the letters A, H, R, or S in the Atr 
  866.       column indicate which of these attributes are set.
  867.  
  868.         /A stands for All files.  It controls whether the directory 
  869.       listing will contain subdirectories (shown as <DIR>, <.> , and 
  870.       <..>) and hidden files.  If the default for /A is OFF, then 
  871.       specifying /A will turn it ON.  If you want to see directories 
  872.       but not the <.> and <..> entries, you can select this option by 
  873.       running SDLSETUP.
  874.  
  875.         /K can be thought of as either arKive or bacKup.  It has 
  876.       limited usefulness, but can be valuable to some of us.  Whenever
  877.  
  878.       MASDIR featuring SDL               Version 5              Page 13
  879.  
  880.  
  881.       a file is changed, DOS "sets the archive bit" in the file's at- 
  882.       tribute byte.  If you use a backup program which clears the ar- 
  883.       chive bit when a file is successfully backed up, the /K option 
  884.       will display only the names of those files needing backup since 
  885.       the last time you ran your backup program.  These files appear 
  886.       with the A in the Atr field of the 2 column display.  Do not con- 
  887.       fuse this use of "archive" with the so-called archiving done by 
  888.       the popular "arc" programs.
  889.  
  890.         If both K and A are in use, hidden files and directories with 
  891.       the archive bit set will also be shown.  You might find two other 
  892.       programs on the MASDIR disk useful in managing attributes and 
  893.       backups.  See ATTR.DOC and COPYNEW.DOC on the disk.
  894.       ------------------
  895.       VOLUME LABELS
  896.  
  897.         SDL displays the volume label in the first line of the header. 
  898.       Volume labels are useful for identifying a specific diskette.  If 
  899.       you want to set or change the volume label displayed, you can 
  900.       easily do so with any of the many volume labelling programs 
  901.       available, including the one in DOS.  You can use the SDL /dos 
  902.       option to do this without exiting to DOS.
  903.  
  904.         Volume labels can be up to 11 characters.  DOS will allow any 
  905.       of the 256 ASCII and extended characters except ."/\[]:*|<>;,? 
  906.       and the lower case alphabetic characters.  (Actually some LABEL 
  907.       programs allow lower case, but since DOS converts lower case to 
  908.       caps it is better to stick with caps.)  Even the space character 
  909.       is allowable in a Volume label.  Therefore, with 216 characters 
  910.       to choose from, there is an almost endless set of combinations 
  911.       that you can use.  To enter the extended characters above 127 
  912.       hold down the Alt key while typing the ASCII code on the number 
  913.       pad keys.  (On some systems it is necessary to hold down both the 
  914.       Alt and the Shift keys while typing an extended character.)
  915.  
  916.         The next section describes one useful application of volume 
  917.       labelling.
  918.         ------------------
  919.         CATALOGING YOUR FLOPPIES WITH SDL
  920.  
  921.         Starting with Version 4.2 it is even easier to create and 
  922.       maintain a catalog of all your floppy disks by using the capabil- 
  923.       ities built into SDL.  The new print-to-file capability intro- 
  924.       duced in Version 4.2 makes creating a copy of a directory in a 
  925.       disk file as easy as pressing a key and typing in a file name. 
  926.       And with Version 4.3 you can create a 40 column file leaving room 
  927.       to the right of each file name for your own full description.
  928.  
  929.         The first, and possibly the hardest, step in creating a 
  930.       cataloging system is to design a naming convention.  In order to 
  931.       find a specific floppy it must have some sort of a name.  The 
  932.       name can be electronically encoded in the volume label of the
  933.  
  934.       MASDIR featuring SDL               Version 5              Page 14
  935.  
  936.  
  937.       diskette.  The V for VOLume label feature introduced in SDL Ver- 
  938.       sion 4.1 can make this job more convenient.
  939.  
  940.         You might like to start the label with one or two characters to 
  941.       indicate the general purpose of the programs or data on the disk. 
  942.       For example you might use UT for utility, or WK for worksheet. 
  943.       You can follow that with combinations of letters and numbers to 
  944.       indicate more specific uses and a numerical sequence.
  945.  
  946.         The easy part is creating the file for the catalog itself.  Use 
  947.       /2 or menu 2 to create a two column display, then at the SDL end 
  948.       menu press P to bring up the print options menu.  For a 40 column 
  949.       file press 3 (for 3.5" disk), then press F to print to a file. 
  950.       You will be asked to enter a file name.  Enter the name of the 
  951.       catalog file you want the directory added to.  You may include 
  952.       drive and path in the file specification if you need to.  Thus 
  953.       you can print the information you want on a disk label or sleeve 
  954.       insert, then store exactly matching information in your disk 
  955.       catalog file.
  956.  
  957.         Using SDL to create your catalog files makes it possible to in- 
  958.       clude up to 3 lines of descriptive information, and to adjust the 
  959.       amount of information that is stored for each file.  The descrip- 
  960.       tive titles are entered by pressing the E key at the end menu and 
  961.       entering the title information at the prompts.  To leave any line 
  962.       unchanged, just press Enter without typing any other keys.
  963.  
  964.         If you want to annotate the file, just use a text editor or 
  965.       your word processor in non-document mode.  Then it is a simple 
  966.       matter to find a specific file.  Just use your word processor or 
  967.       text editor to search the catalog file for a file name, a key 
  968.       word, or any fragment of text that might appear in a file name, 
  969.       volume label, or your description.  When you find the right disk, 
  970.       remember the volume label, then go to your disk storage and pull 
  971.       out that volume and you have the one you want.  If you have a lot 
  972.       of floppies you may want to set up several catalog files for dif- 
  973.       ferent series of diskettes.
  974.  
  975.       ------------------
  976.       BATCH PROGRAMMING
  977.  
  978.        For you BATch programmers, SDL can be used to report the number 
  979.       of files that match a specification.  Upon exiting, SDL places 
  980.       the number of files (up to 255) in the ERRORLEVEL that BATch 
  981.       files can check with the IF ERRORLEVEL statement.  Be sure to use 
  982.       the /M parameter to avoid your BATCH file pausing for input.  If 
  983.       you do not want to see the display of file names, you can 
  984.       redirect output to the NUL device by including >NUL in the com- 
  985.       mand line.  Of course, IF EXIST is a way to check for the exis- 
  986.       tence of one or more files, but if the number of files is impor- 
  987.       tant, SDL would be a way to get it.  Also, older versions of IF 
  988.       EXIST do not recognize paths, so SDL would be a way to check for 
  989.       the existence of a file in a sub-directory.
  990.  
  991.       MASDIR featuring SDL               Version 5              Page 15
  992.  
  993.  
  994.       ---------------
  995.  
  996.       MASDIR featuring SDL               Version 5              Page 16
  997.  
  998.  
  999.       CUSTOMIZATION:
  1000.  
  1001.         One of the best features of the SDL package is the menu driven 
  1002.       program SDLSETUP.BAT.  To customize the defaults and title lines, 
  1003.       simply run SDLSETUP and follow the prompts.  If more information 
  1004.       is required read the next section, see SDLSETUP.DOC on the disk, 
  1005.       or enter SETUP at the DOS prompt.
  1006.  
  1007.         The following items can be adjusted in SDLSETUP:
  1008.  
  1009.         All files option off or on, /A toggles it.  In addition you can 
  1010.           suppress the . and .. subdirectory entries.
  1011.         Hdr option off or on, /H or H toggles it.
  1012.         Cls option off or on, /C toggles it.
  1013.         More (pause) option off or on, /M toggles it.  Or later select 
  1014.           P for the switch character in addition to M, then use R for 
  1015.           pRinting.
  1016.         Default SORT order Name, eXtension, Date, or nOne.
  1017.         Default number of COLumns AUTOmatic, 2, or 4.
  1018.         Your own TITLES installed in first two header lines.
  1019.         Either full or half page eject for sleeve inserts.
  1020.         Disk Free space option off or on, /F or F toggles it.
  1021.         Print using the extended ASCII box drawing characters vice sub- 
  1022.           stituted characters.
  1023.         Adjust the number of file names per column for Tiny print.
  1024.         Specify color or mono--useful for monochrome graphics displays.
  1025.  
  1026.           SDL can be customized for printers that are not Epson com- 
  1027.       patible if you send your printer codes along with your original 
  1028.       MASDIR disk and a $5 handling fee.
  1029.  
  1030.           Even though SDL is so useful, it is sometimes difficult to 
  1031.       get out of the habit of typing DIR.  If you are a user of CED (or 
  1032.       PCED) or one of the other command editors that allows synonyms or 
  1033.       aliases, you can make SDL a synonym for DIR.  Alternatively, it 
  1034.       is easy to modify COMMAND.COM so that when you forget and enter 
  1035.       DIR, SDL will be run instead.  If you can't find the information 
  1036.       on how to patch COMMAND.COM, write for a free information sheet. 
  1037.       If you use either of these methods to let DIR mean SDL, the 
  1038.       normal DOS directory listing will still be available if you 
  1039.       should need it for some reason.
  1040.       ---------------
  1041.       RUNNING SDLSETUP
  1042.  
  1043.       NOTE: SDLSETUP will not modify any of your original files.  Only 
  1044.       SDL.COM will be affected.  In particular, your CONFIG.SYS and 
  1045.       AUTOEXEC.BAT will not be touched.
  1046.  
  1047.       SDLSETUP is a handy program to customize many of the options of 
  1048.       SDL.COM, the Sorted Directory and disk Label printing program. 
  1049.       It requires only that you answer a series of questions with 
  1050.       single keystroke responses and, if you care to, input new titles 
  1051.       to appear in the top 2 lines of the display.
  1052.  
  1053.       MASDIR featuring SDL               Version 5              Page 17
  1054.  
  1055.  
  1056.  
  1057.       To run SDLSETUP establish a working disk or directory (a RAM disk 
  1058.       will be fastest, a directory on a hard disk next, and a floppy 
  1059.       can be quite slow).  Enter the following command to copy the 
  1060.       necessary files from the MASDIR diskette to your working area. 
  1061.       Assume that the MASDIR diskette is in drive B: and the working 
  1062.       area is the current directory on drive C:.  Then just enter
  1063.  
  1064.           COPY B:SDL*.* C:
  1065.  
  1066.       You can add the path after C: if you care to, or just issue this 
  1067.       command after changing to the working disk or directory.  You can 
  1068.       use MAKEWORK to help you do this if you like.  Enter MAKEWORK at 
  1069.       the DOS prompt.
  1070.  
  1071.       There are two features that make SDLSETUP faster to use.  The 
  1072.       first is the Carriage Return (cr) response.  Just pressing Return 
  1073.       (called Enter on some models) will leave that particular default 
  1074.       unchanged.  This saves the time of figuring out what the proper 
  1075.       response should be for items that you don't want to change.  The 
  1076.       other time saver is the Escape (Esc) response.  SDLSETUP is 
  1077.       organized into sections.  Pressing Esc will skip to the end of 
  1078.       the current section and take up again at the beginning of the 
  1079.       next section.
  1080.  
  1081.       Several of the defaults and their switches are "toggles".  A tog- 
  1082.       gle has two settings, generally "off" and "on".  The switch on 
  1083.       the command line, or a selection from a menu, changes the posi- 
  1084.       tion of the toggle.  When you set the default position of a tog- 
  1085.       gle, you can always toggle it back with the switch.
  1086.  
  1087.       All of the questions in SDLSETUP are self-explanatory and should 
  1088.       cause no confusion.  A few of them are explained in a little more 
  1089.       detail here.  If you have any questions, read on.  Then if you 
  1090.       still have questions after running SDLSETUP please contact me.
  1091.       - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1092.       At your DOS prompt enter SDLSETUP
  1093.  
  1094.       You will see the message: Checking system resources. Please wait.
  1095.  
  1096.       At this point SDLSETUP is looking for the DOS DEBUG external com- 
  1097.       mand.  If it is not found you will see the message "Bad command 
  1098.       or file name".  This will be followed by a beep and the follow- 
  1099.       ing:
  1100.  
  1101.        The message "Bad command or file name" that you just saw means 
  1102.       that a system file is not available to SDLSETUP. This program re- 
  1103.       quires access to the DOS external command file DEBUG.COM.  It 
  1104.       must be in this directory on this disk or in one of the direc- 
  1105.       tories on your path, which is
  1106.  
  1107.       PATH=     (REM: your current path will be displayed here).
  1108.  
  1109.       MASDIR featuring SDL               Version 5              Page 18
  1110.  
  1111.  
  1112.  
  1113.       Please correct the problem and run SDLSETUP again.
  1114.  
  1115.       (REM: One user reported a problem during this portion of the set- 
  1116.       up program, and it turned out that he was running a RAM resident 
  1117.       (TSR) program named DOSEDIT. This appeared to interfere with the 
  1118.       redirected input to DEBUG. The solution was just to boot the com- 
  1119.       puter without DOSEDIT temporarily while running SDLSETUP.)
  1120.  
  1121.       (REM: This will be followed by an exit back to DOS for corrective 
  1122.       action. But if DEBUG is found, SDLSETUP will check for the 
  1123.       presence of other files.  Depending on what is found you may see 
  1124.       some of the following messages.  If you don't see them, then all 
  1125.       is well.)
  1126.  
  1127.       Next the presence of required files will be verified. If any 
  1128.       needed files are not present, you will see ...
  1129.  
  1130.       The following files must be in this current directory on this 
  1131.       disk:
  1132.       SDL.COM
  1133.       SDL_GET.COM
  1134.       SDLTITLE.COM
  1135.       SDLSETUP.BAT
  1136.       SDLPARMS.BAT
  1137.       SDLNOTOG.BAT
  1138.       SDLFINIS.BAT
  1139.       SDLDEBUG.BAT
  1140.  
  1141.       The DOS version will be checked. If it is found to be version 2.x 
  1142.       you will see the following message. Please see the note at the 
  1143.       end of this DOC file.
  1144.  
  1145.       If you have any difficulty running SDLSETUP under DOS 2.x, please 
  1146.       see SDLSETUP.DOC.
  1147.  
  1148.        Setting the More or Pause default...
  1149.  
  1150.       Pausing refers to both intermediate pauses if the directory is 
  1151.       more than one page (screen), and the pause at the end to allow 
  1152.       you to select a new option. This is merely personal preference, 
  1153.       but pausing is a good idea, and it allows you to select new op- 
  1154.       tions.
  1155.  
  1156.        Setting the Hdr default...
  1157.  
  1158.       The first two lines of the header contain the copyright notice 
  1159.       and the reminder line, as well as the volume label. If you use 
  1160.       SDL mostly for directories on the your hard disk drive, you may 
  1161.       have no need for the first two lines as a rule.  This permits 2 
  1162.       more rows of files to be shown on the screen. The directory name 
  1163.       will still be shown, and you can restore the title lines for any
  1164.  
  1165.       MASDIR featuring SDL               Version 5              Page 19
  1166.  
  1167.  
  1168.       display with the /H option. Later during SDLSETUP you will be 
  1169.       given the opportunity to change the default titles in these two 
  1170.       lines.
  1171.  
  1172.        Setting the sleeve Insert eject default...
  1173.  
  1174.       A half page saves paper if you print many Inserts. Then if you 
  1175.       print an even number of inserts your TOF setting will not be 
  1176.       changed, but if you print an odd number your printer will be left 
  1177.       at the middle of a page. If you prefer to always use a full page 
  1178.       for a sleeve Insert, you can set that here.
  1179.  
  1180.        Installing your own default title lines...
  1181.  
  1182.       If you answer N you are finished, and SDLSETUP will call DEBUG to 
  1183.       make the changes you have requested. If you answer Y, another 
  1184.       program, SDLTITLE.COM, will be called to ask you for the titles 
  1185.       you want. The first line title can be 44 characters long and the 
  1186.       second line can be 79 characters long. If you want to change only 
  1187.       one, just press ENTER for the other. Whenever you just press EN- 
  1188.       TER, the original title will be used. If you want to blank out a 
  1189.       title completely, just enter one or more spaces. If you want to 
  1190.       have your own titles on the first two lines you will have to en- 
  1191.       ter them both even though you may just be changing one of them 
  1192.       from a previous setting.
  1193.  
  1194.       To restore the original titles, simply press ENTER at each 
  1195.       prompt. Setting your own titles or restoring the original titles 
  1196.       eliminates the highlighting of the key characters in the reminder 
  1197.       line and allows all lines of the directory display to be 
  1198.       redirected to a file using the DOS redirection facility when ap- 
  1199.       propriate.
  1200.  
  1201.       After setting the titles the program will run to completion. The 
  1202.       only problem that can arise is no access to DEBUG. In that case 
  1203.       you will see the following message.
  1204.  
  1205.       Bad command or file name
  1206.  
  1207.       Using the DOS DEBUG command appears to have failed! You may not 
  1208.       have a path to DEBUG. Please check the directories on your path 
  1209.       for the existence of DEBUG.COM. If you can establish a path to 
  1210.       DEBUG or copy DEBUG.COM to this working area, you can install the 
  1211.       changes you have made by entering SDLDEBUG.
  1212.  
  1213.       If you see this message, please make DEBUG available from your 
  1214.       version of DOS and run SDLSETUP again. In fact, if you have got- 
  1215.       ten this far you can take a short cut and run SDLDEBUG after you 
  1216.       have made DEBUG available. That will finish up the changes.
  1217.  
  1218.        (CAUTION: Do NOT run SDLDEBUG if there has been any other error 
  1219.       or interruption. In that case it is safer to start over again,
  1220.  
  1221.       MASDIR featuring SDL               Version 5              Page 20
  1222.  
  1223.  
  1224.       but see the NOTE below. SDLDEBUG uses redirection and if the in- 
  1225.       put file SDLSETUP.TXT has not been completed, it can cause a 
  1226.       hangup that will require a reboot.)
  1227.  
  1228.       If everything completed normally you will see the message...
  1229.  
  1230.       SDL.COM has been modified. Don't forget to COPY your new version 
  1231.       of SDL.COM to the disk and/or directory with your other DOS com- 
  1232.       mands and utilities.
  1233.       - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1234.       That's all there is to it, so enjoy using SDL with your own con- 
  1235.       figuration.
  1236.  
  1237.       SDLSETUP creates two working files named SDLSETUP.TXT and 
  1238.       SDLTITLE.TXT. These files will be erased when SDLSETUP is fin- 
  1239.       ished with its work.
  1240.  
  1241.       NOTE: I have run into an occasional problem running SDLSETUP un- 
  1242.       der DOS 2.1. Generally it works fine, and I can detect no prob- 
  1243.       lems under DOS 3 or later, but if you see either of the messages 
  1244.       "EXEC failure" or "File creation error" please let me know. You 
  1245.       might try increasing the "FILES=" value in your CONFIG.SYS file 
  1246.       and reboot. A remote possibility is that the directory is full, 
  1247.       so you might try running it on a different drive or in a dif- 
  1248.       ferent directory. You can also run CHKDSK to see if there are any 
  1249.       other conditions that might cause the error.
  1250.  
  1251.       This problem is apparently caused by a bug or deficiency in DOS 
  1252.       2.1, but I have included a work-around for it. If you see either 
  1253.       of the above messages, AND if SDLSETUP has finished all of its 
  1254.       questions through the ones about changing the titles, then reboot 
  1255.       with Ctrl-Alt-Del and get back to the drive and directory in 
  1256.       which you were running SDLSETUP. (If you are working on a RAM 
  1257.       disk, copy your work to a permanent disk first.) One or two of 
  1258.       the .TXT files named above should be in that directory (2 if you 
  1259.       changed titles, otherwise only the first one). If you see 
  1260.       SDLSETUP.TXT you can run SDLDEBUG, the last batch file in the 
  1261.       series. This should install your changes and clean up after it- 
  1262.       self. See the CAUTION above about other types of problems. I 
  1263.       apologize for any inconvenience, but it is a problem beyond my 
  1264.       control.
  1265.  
  1266.       As a last resort, run SDLSETUP on a machine that is running DOS 3 
  1267.       or later. Then copy the resulting SDL.COM to your machine. Good 
  1268.       luck!
  1269.  
  1270.       MASDIR featuring SDL               Version 5              Page 21
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.                        LICENSE AND WARRANTY STATEMENTS
  1277.  
  1278.       This software is protected by both United States Copyright Law 
  1279.       and International Treaty provisions.  Therefore, you must treat 
  1280.       this software JUST LIKE A BOOK with the following single excep- 
  1281.       tion.  You are authorized to make archival copies of the software 
  1282.       for the purposes of backing up your software and making a working 
  1283.       copy to protect your investment from loss.
  1284.  
  1285.       By saying "just like a book" is meant, for example, that this 
  1286.       software may not be used on one computer at the same time that it 
  1287.       is being used on another.  Just like a book that can't be read by 
  1288.       two different people in two different places at the same time.
  1289.  
  1290.       With respect to the physical diskette, Monterey Bay Disk Data 
  1291.       Systems ("MOBY DISK") warrants the same to be free of defects in 
  1292.       material and workmanship.  In the event of notification and 
  1293.       return of the defective material, Moby Disk will replace it in 
  1294.       like kind.  The remedy for breach of this warranty shall be 
  1295.       limited to replacement and shall not encompass any other damages, 
  1296.       including but not limited to loss of profit, special, incidental, 
  1297.       consequential, or other similar claims.
  1298.  
  1299.       MOBY DISK specifically disclaims all other warranties, expressed 
  1300.       or implied, including but not limited to implied warranties of 
  1301.       merchantability and fitness for a particular purpose with respect 
  1302.       to defects in the diskette and documentation, and the program li- 
  1303.       cense granted herein in particular, and without limiting opera- 
  1304.       tion of the program license with respect to any particular ap- 
  1305.       plication, use or purpose.  In no event shall Moby Disk be liable 
  1306.       for any loss of profit or any other commercial damage, including 
  1307.       but not limited to special, incidental, consequential or other 
  1308.       damages.
  1309.  
  1310.       This statement shall be construed, interpreted and governed by 
  1311.       the laws of the state of California.  MOBY DISK and Monterey Bay 
  1312.       Disk Data Systems are registered business names of Bob Stephan, 
  1313.       1021 San Carlos Road, Pebble Beach, CA  93953.
  1314.